home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / atw11.zip / TJHELP.TXT < prev    next >
Text File  |  1996-01-26  |  20KB  |  525 lines

  1.  
  2.                     TIPS AND TRICKS FROM T&J SOFTWARE
  3.                     Revised: 10/11/1995
  4.  
  5.  
  6. Section I       - Display Problems
  7. Section II      - DigiBoards & Fossil Drivers
  8. Section III     - Overflow Errors
  9. Section IV      - Miscellaneous Errors
  10.  
  11.  
  12.  
  13. ──────────────────────────────────────────────────────────────────────────────
  14.                        SECTION I - DISPLAY PROBLEMS
  15. ──────────────────────────────────────────────────────────────────────────────
  16.  
  17.  
  18.  
  19.  
  20. ANSI Control Codes on the LOCAL monitor:
  21. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22. If you encounter screen fulls of garbage on the local monitor when
  23. running a T&J Software Door, please follow these simple directions:
  24.  
  25. NOT RUNNING DESQVIEW
  26. ~~~~~~~~~~~~~~~~~~~~
  27. If you are not running DESQview, you need to add ANSI.SYS to you
  28. CONFIG.SYS file. Do the following:
  29.  
  30. 1. Add this line to your CONFIG.SYS file (placement is not important).
  31.    DEVICE=C:\DOS\ANSI.SYS
  32.  
  33. 2. Reboot the machine.
  34.  
  35. RUNNING DESQVIEW
  36. ~~~~~~~~~~~~~~~~
  37. If you are running DESQview, you need to run DVANSI.COM in EACH node
  38. batch file. DVANSI.COM can be found in your DESQview directory. Here's
  39. an example of my CAT1.BAT file:
  40.  
  41. @echo off
  42. :cat
  43. cd\dv
  44. dvansi
  45. SET WCNODEID=1
  46. SET WCPORTID=2
  47. SET WCIRQID=3
  48. CD \Wildcat
  49. WILDCAT
  50. if exist c:\wildcat\wcwork\node1\event.bat c:\wildcat\wcwork\node1\event.bat
  51. if exist c:\wildcat\wcwork\node1\dropdos.bat c:\wildcat\wcwork\node1\dropdos.bat
  52. if exist c:\wildcat\wcwork\node1\door.bat c:\wildcat\wcwork\node1\door.bat
  53. if exist c:\wildcat\wcwork\node1\postcall.run c:\wildcat\wcwork\node1\postcall.bat
  54. IF ERRORLEVEL 1 GOTO CAT
  55. REM END
  56. atsend z 2
  57.  
  58. Note line 3 and 4. That's all you need to do!
  59.  
  60. ANSI under OS/2 (prepared by Mark Ingenito) - Thanks!
  61. ~~~~~~~~~~~~~~~
  62. OS/2 does not automatically install ANSI support. However, it's
  63. easy enough to add this support, and you can find what you need
  64. to accomplish this in your \OS2\MDOS directory. You need just
  65. one file - ANSI.SYS.
  66.  
  67. There are two methods you can install ANSI.SYS on your OS/2
  68. system:
  69.  
  70.  1. This method will enable ANSI support for this particular DOS
  71.     session ONLY:
  72.  
  73.   - On your desktop, right click on the DOS session icon you're
  74.     using for your BBS node.
  75.   - Left Click on SETTINGS
  76.   - Left Click on SESSION tab
  77.   - Left Click on DOS SETTINGS
  78.   - Left Click on ALL DOS SETTINGS
  79.   - Left Click or move highlight bar to DOS_DEVICE
  80.   - In the text box that will appear to the right, type the
  81.     following:
  82.  
  83.     "x:\os2\mdos\ansi.sys", without the quote marks, where "x:" is the
  84.                             drive where OS/2 resides.
  85.  
  86.   - Now, Left Click on SAVE button at bottom of window, ALT-F4 to close
  87.     settings box. Now, when you open this DOS session, you will have ANSI
  88.     support! By the way, a reboot is NOT necessary when using this method
  89.     of adding MDOS device drivers.
  90.  
  91.  
  92.  2. This method will enable ANSI support in ALL DOS sessions:
  93.  
  94.   - From your desktop, Double-Left Click on OS/2 SYSTEM icon.
  95.   - Double-Left Click on PRODUCTIVITY
  96.   - Double-Left Click on ENHANCED EDITOR.(You can use any OS/2
  97.     editor you wish, actually)
  98.   - Open your CONFIG.SYS file and page down to the section of the file that
  99.     contains the device driver lines for DOS sessions. These lines normally
  100.     begin with and follow the line "SHELL=C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS".
  101.   - Insert the line "DEVICE=C:\OS2\MDOS\ANSI.SYS", without the quotes, on the
  102.     next line following the SHELL= statement.
  103.   - SAVE your changes.
  104.   - Close your editor.
  105.  
  106.     You will now need to perform a SHUTDOWN and reboot your system for
  107.     this change to take effect.
  108.  
  109. Garbled Information on Remote
  110. =============================
  111. * If the door seems to operate fine on the BBS end but the remote
  112.   cannot receive or receives garbled information, check and make sure
  113.   you are passing the correct IRQ to the door (if you are running a
  114.   non standard IRQ).
  115.  
  116. TRIBBS v5.02+
  117. =============
  118. * Color ANSI checking will not work if you use TRIBBS.SYS drop file.
  119.   Set the doors up using the PCBOARD.SYS drop file.
  120.  
  121. Graphic Cards (general)
  122. =======================
  123. * ATI Graphics Ultra Pro card - do not use the ANSI.SYS driver that
  124.   came with the card. Use the normal DOS ANSI.SYS for the screens
  125.   to show correctly.
  126.  
  127. * Trident SVGA Cards - You should have a utility disk with a file
  128.   called TANSI.SYS, use this ansi driver instead of the standard
  129.   ANSI.SYS.
  130.  
  131.  
  132.  
  133.  
  134. ──────────────────────────────────────────────────────────────────────────────
  135.                 SECTION II - DIGIBOARDS & FOSSIL DRIVERS
  136. ──────────────────────────────────────────────────────────────────────────────
  137.  
  138.  
  139.  
  140.  
  141. SearchLight BBS and DigiBoards
  142. ==============================
  143. To set up on a SLBBS with a DIgiboard....
  144.                     
  145.                     E D I T   C O M M A N D
  146.  
  147.                 Press F1 to Change Command Type
  148.   1. Command Name .................. STUD's
  149.   2. Command Key ................... U
  150.   3. Description ................... Become the alltime STUD on the board
  151.   4. Event Logging ................. No
  152.   5. Access Levels & Graphics [...]
  153.   6. Door Command .................. c:\slbbs\door\stud\studs.bat %O
  154.   7. Directory Path ................ .
  155.   8. Communications Support ........ Fossil
  156.   9. Abort Method .................. None
  157.  10. Write Protection .............. No
  158.  11. Parameter File ................ DOOR.SYS
  159.  12. Pause After Door .............. No
  160.  13. Pass Username As .............. Login Name
  161.  14. Pass COM Port As .............. COM1-COM4
  162.  
  163. REM  ( DFTSR loads in your AUTOEXEC.BAT no other subcommands needed with it, 
  164. REM  as long as your Digiboard 4, 8 or 16 starts at 0 for the first channel.)
  165.  
  166. DFTSR
  167.                This is for multi-node Node 1 below.....
  168.  
  169. REM ( Batch file called out from BBS door with Node command %O for SLBBS.)
  170. @ECHO OFF
  171. c:
  172. cd \slbbs\door\stud
  173. stud%1.bat
  174. REM ( this would be STUD1.BAT )
  175. DF FOSSIL-LOCK 12     (turns fossil driver on at channel 12)
  176. c:
  177. CD \slbbs\DOOR\STUD
  178. STUDS! studs1.cfg /FD
  179. DF DIGI 12            (turns fossil off so it can return to the DIGIBOARD)
  180. c:
  181. cd \slbbs1
  182.  
  183. REM  ( This would be STUDS1.CFG )
  184. C:\SLBBS1\DOOR.SYS
  185. The Bart Stop BBS
  186. Bartman
  187. S.
  188.  
  189. DigiFossil Information
  190. ======================
  191.  
  192.                         DIGIFOSSIL V2.2 - Jun 6, 1995
  193.                         FOSSIL Driver for Digi-Boards
  194.                         & DIGIBOARD Driver for FOSSIL
  195.                         =============================
  196.                                               Technique Computer Systems
  197.                                               Victoria, BC  CANADA
  198.                                               BBS: (604) 361-1541
  199.                                               FAX: (604) 361-4789
  200.                                             email: scott@plywood.bcbbs.net
  201.  
  202.   What is DIGIFOSSIL?
  203.   -------------------
  204.   DIGIFOSSIL is the program (DFTSR) you need  in order to get a huge number
  205.   of applications written for  FOSSIL systems working on  your BBS, if your
  206.   BBS uses  an intelligent  Digiboard (such as  the PC/Xe,  PC/Xi or COM/Xi
  207.   series).  (if you need a FOSSIL for a nonDigiboard system, try either X00
  208.   or BNU, which are available from many BBSs).
  209.  
  210.   DIGIFOSSIL also  includes a program  (FDTSR) to run  your Digiboard based
  211.   BBS on a non-digiboard (FOSSIL) setup.   This allows you to use a product
  212.   such as Wildcat! IM (where they haven't implemented FOSSIL support).
  213.  
  214.   Legal Stuff
  215.   -----------
  216.   DIGIFOSSIL is Copyright 1992-1995, Technique Computer Systems, all rights
  217.   reserved.  This product is provided "AS-IS" without warranty of any kind.
  218.  
  219. RENEGADE BBS
  220. ============
  221. * If you are using BNU fossil driver and having problems with the
  222.   doors, try using X00 v1.50+. Several Renegade systems have reported
  223.   problems using BNU with the doors.
  224.  
  225. WILDCAT
  226. =======
  227. * Wildcat! IM Version Setup using DigiFossil v2.x:
  228.  
  229.   All of our doors will run on the Wildcat! IM version using DigiFos
  230.   v2.x. I have received TWO different setup routines concerning the
  231.   IM version, here's an example:
  232.  
  233.   DF LOCK%WCNODEID%            -OR-      DF ON
  234.   CD\WC30\DOOR\STUDS                     CD\WC30\DOOR\STUDS
  235.   STUDS! STUDS!.CFG /FD                  STUDS! STUDS!.CFG
  236.   CD\WC30                                CD\WC30
  237.   DF OFF                                 DF OFF
  238.  
  239.   Comments on either setup would be greatly appreciated!
  240.  
  241. The following instructions will help you run these doors on a multi-node 
  242. system using a Digiboard card for multi-line capability.
  243.  
  244. First, you will need a copy of Digifossil, a freeware fossil driver which
  245. was written specifically for use with a Digiboard.  Digifossil can be 
  246. found on many BBS systems under the name DFTSR.EXE or can be obtained
  247. from this BBS.
  248.  
  249. Secondly, make sure that digifossil is in your root directory and in your
  250. autoexec.bat so that it becomes resident at boot-up. Digifossil consists
  251. of two files, df.exe and dftsr.exe, both must be located in your root
  252. directory.
  253.  
  254. Third, you must edit your doorx.bat or doorx.run file to turn the Digifossil
  255. on and lock the baud rate when the door is accessed. Below is a sample of my
  256. doorx.bat file.
  257.  
  258. cd\wc30\doors\game   <-------------- The directory where the door is located.
  259. df lock              <-------------- Turn on the digifossil and lock the baud
  260. game game.cfg     
  261. df off               <-------------- Turn off the digifossil
  262. cd\                  <-------------- return to the board
  263.  
  264. Its really that simple. Everything remains the same except for the two lines
  265. that turn the digifossil on and off.
  266.  
  267.  
  268.  
  269.  
  270. ──────────────────────────────────────────────────────────────────────────────
  271.                      SECTION III - OVERFLOW ERRORS
  272. ──────────────────────────────────────────────────────────────────────────────
  273.  
  274.  
  275.  
  276.  
  277. WILDCAT! 4.x
  278. ============
  279. * Problems may develop using the DOOR.SYS drop file if you have
  280.   a LARGE number of conferences. I would suggest picking up a copy
  281.   of a file called FDOORSYS.ZIP written by Tim Rider (Tim can be
  282.   reached on The Source BBS at 310-371-3737). Here is what Tim's
  283.   documentation states:
  284.  
  285.   "WildCat! v4.0 allows up to 32,000 conference areas.  Due to the
  286.    specifications of DOOR.SYS, all the conferences that a user is
  287.    joined to are written to line #23 of DOOR.SYS.  32,000 conferences
  288.    takes up a lot of room, and some SysOps have a DOOR.SYS file that may
  289.    end up to be over 100k.  Some doors have been choking on the large
  290.    DOOR.SYS, so I wrote this small utility to remove that line."
  291.  
  292.    from FDOORSYS.DOC by Tim Rider
  293.  
  294. * More recent versions of Wildcat allow you to select the option to
  295.   use the "short" form of DOOR.SYS to correct this problem. This can
  296.   be toggled in MakeWild.
  297.  
  298. Remote Access v2.0+
  299. ==================
  300. * Using DOOR.SYS may result in an OVERFLOW error -- try using a
  301.   different caller drop file such as DORINFO1.DEF. This is currently
  302.   being examined!
  303.  
  304. Overflow Errors
  305. ===============
  306. * Overflows can occur if you are running under DESQview and your tick
  307.   counts are set too low -- try raising the tick counts.
  308.  
  309. * If you're running Wildcat! v3.9+ and are getting OVERFLOW errors,
  310.   make sure NONE of your security level definitions have the MAXIMUM
  311.   DAILY DOWNLOADS set to more than 32,000 -- anything over that will
  312.   cause an OVERFLOW ERROR in ANY door using DOORFRAME.
  313.  
  314.  
  315.  
  316.  
  317.  
  318. ──────────────────────────────────────────────────────────────────────────────
  319.                     SECTION IV - MISCELLANEOUS ERRORS
  320. ──────────────────────────────────────────────────────────────────────────────
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. RANDOM LOCKUPS
  328. ==============
  329. * If you are getting random lockups with your BBS, check your FILES=
  330.   section of your CONFIG.SYS file. My recommendations would be settings
  331.   this to 45 + 20 for each additional node. This may vary from BBS
  332.   package to BBS package.
  333.  
  334. RENEGADE BBS
  335. ============
  336. * If you are getting out of memory errors. Go into the System Config
  337.   section, [E] System Toggles, then [U] to turn the SWAP FILE 'ON'.
  338.  
  339. TRIBBS v5.01+
  340. =============
  341. * If you use DOOR.SYS, TriBBS reloads this file and will deduct twice
  342.   the amount of time that was actually used. Try using another drop
  343.   file, or copying the DOOR.SYS to a seperate directory and then
  344.   telling the door to look there for it.
  345.  
  346. * NOTE: This only applies to doors that you adjust the users time in
  347.         the door such as Bordello, Studs, and Studette.
  348.  
  349. T&J Raffle
  350. ==========
  351. * An ILLEGAL FUNCTION CALL will result if you enter a "closing
  352.   date" that is not valid. If you want the door to lock at the
  353.   end of the month, then put in the first of the month.
  354.  
  355. Keyboard Timeouts
  356. =================
  357. * If you are operating on a 486 computer and getting a "keyboard
  358.   timeout", you will need to set the following environmental variable
  359.   in your AUTOEXEC.BAT.
  360.  
  361.   SET NO87=ON
  362.  
  363.   This will turn off your co-processor and allow the door to function
  364.   properly
  365.  
  366. DESQview Users
  367. ==============
  368. * Make sure you have the MATH COPROCESSOR flagged ON even if you don't
  369.   have a math coprocessor.
  370.  
  371. Lockups on certain COM PORTS
  372. ============================
  373. * If you're running on a non-standard IRQ, be sure you are passing the
  374.   IRQ on the command line!! Example:  STUDS! STUDS!.CFG /5
  375.  
  376.   Studs! will now run on IRQ 5.
  377.  
  378. Spitfire BBS's
  379. ==============
  380. * If you're having trouble with the doors dropping carrier on exiting
  381.   back to the BBS, switch to using DOOR.SYS instead of SFDOORS.DAT.
  382.   On some Spitfire configurations this will happen when using
  383.   SFDOORS.DAT.
  384.  
  385. Bulletin PATHS and FILENAMES
  386. ============================
  387. * When specifying the bulletin path, be sure to also select a name
  388.   for the bulletin! This could cause lockups when using Bordello,
  389.   Strip Poker, and Video Poker. If you don't want bulletins created,
  390.   simply enter the word NONE for the path and filename.
  391.  
  392. REGISTERED KEYS
  393. ===============
  394. * Distribution of a registered key is against copyright laws, which
  395.   carries significant penalties. If a registered key is found being
  396.   distributed, all keys purchased from us (by the person distributing
  397.   the keys) will be invalidated and the matter will be turned over to
  398.   our attorney's. We do share this information with other shareware
  399.   authors.
  400.  
  401. SHARE.EXE
  402. =========
  403. * SHARE.EXE must be loaded in order to play the doors on multi-node
  404.   systems. Here a segment of my AUTOEXEC.BAT showing how I load
  405.   SHARE.EXE:
  406.  
  407.   C:\QEMM\LOADHI /R:3 C:\DOS\SHARE /f:4096 /l:60
  408.  
  409. SYNCHRONET BBS DOOR SETUP
  410. =========================
  411.  
  412. Hi Tom,
  413.    Here is the Synchronet config for Money Market. What
  414. follows is a completed entry for it in the Synchronet v2.10
  415. Configuration Program. A few items (those marked with a `*')
  416. are not present in v2.00. If you are setting it up for that
  417. version, just ignore these.
  418.  
  419.    NAME                         Money Market
  420.    INTERNAL CODE                MONEYM
  421.    START-UP DIRECTORY           C:\SBBS\XTRN\MM
  422.    COMMAND LINE                 MONEYM.EXE MONEYM.CFG
  423.    CLEAN-UP COMMAND LINE
  424.    COST IN CREDITS              0
  425.  * EXTRA MINUTES                0
  426.  * SUSPEND [FREE] TIME          NO
  427.    ACCESS REQUIREMENTS
  428.    EXECUTION REQUIREMENTS
  429.    MULTIPLE CONCURRENT USERS    YES
  430.    INTERCEPT I/O INTERRUPTS     NO
  431.    SWAP BBS OUT OF MEMORY       YES
  432.    MODIFY USER DATA             NO
  433.    EXECUTE ON EVENT             NO
  434.    BBS DROP FILE TYPE           DOOR.SYS
  435.    PLACE DROP FILE IN           NODE DIRECTORY
  436.  
  437.    Here is a more detailed description of what each entry
  438. does, so that you may have a better understanding when you are
  439. assisting someone in setting up a door on a SBBS system.
  440.  
  441. NAME: Name of the program to be displayed on-line
  442. INTERNAL CODE: A unique code used by Synchronet to identify
  443.    the program.  May be just about anything.
  444. START-UP DIRECTORY: Directory where door files are located.
  445. COMMAND LINE: Exact command line to execute door. May be a
  446.    batch file if necessary. Also may contain variables to pass
  447.    parameters to the door. Some are as follows:
  448.         %a User Alias/Name
  449.         %d Connect Rate
  450.         %m Minutes left
  451.         %# BBS Node #
  452.         %p Com Port #
  453. CLEAN-UP COMMAND LINE: Executed immediately after door is
  454.    completed. Usually not used.
  455. COST IN CREDITS: Used to charge users additional credits for
  456.    running the door.
  457. *EXTRA MINUTES: Used to give users sxtran time for running
  458.    door (Only in version 2.10).
  459. *SUSPEND [FREE] TIME: Time spent in door does not count
  460.    towards users time online (Only in version 2.10).
  461. ACCESS REQUIREMENTS: Limits who is able to see the door on the
  462.    menu screens. May be set to a particular flag, security
  463.    level, Ansi only, local only, user number, etc.
  464. EXECUTION REQUIREMENTS: Limits who is able to run the door.
  465. MULTIPLE CONCURRENT USERS: Set to yes if door supports
  466.    multiple nodes simultaneously or no if door supports only
  467.    single nodes.
  468. INTERCEPT I/O INTERRUPTS: Allows many DOS programs not
  469.    intended for BBS use to run on SBBS. Always set to no for
  470.    actual door programs.
  471. SWAP BBS OUT OF MEMORY: Frees system memory to run large
  472.    programs. I generally set it to yes although most
  473.    programs don't require it.
  474. MODIFY USER DATA: Will allow changes to user info within SBBS
  475.    to be made based on info within the drop file. If set to
  476.    no, only time online is updated. If set to yes, other user
  477.    stats may be modified, depending on which drop file is used.
  478. EXECUTE ON EVENT: Will allow a door to be executed as a logon,
  479.    logoff, or user birthday event.
  480. BBS DROP FILE TYPE: Select from DOOR.SYS PCBOARD.SYS USERS.SYS
  481.    CHAIN.TXT DORINFO#.DEF EXITINFO.BBS SFDOORS.DAT CALLINFO.BBS
  482.    DOORFILE.SR UTIDOOR.TXT
  483. PLACE BBS DROP FILE IN: Select from NODE DIRECTORY or STARTUP
  484.    DIRECTORY (as entered above).
  485.  
  486.    I hope that this info is what you needed. If you or any
  487. other users have questions about SBBS, please feel free to
  488. refer the questions to me through e-mail or give me a call. I
  489. will be glad to help any way I can.
  490.                                           Shawn O'Brian
  491.  
  492. ERROR Codes (general)
  493. =====================
  494. * ERROR #53 - This error means a file was not found. If this occurs
  495.   right when the door is opened, please check the PATH to the caller
  496.   drop file (i.e. DOOR.SYS), or make sure the caller drop file is
  497.   being created properly!
  498.  
  499.                             QuickBasic Error codes
  500.                       DoorFrame uses the QB error codes.
  501.  ---------------------------------------------------------------------------
  502.  
  503.  2   Syntax Error                       61   Disk full
  504.  5   Ilegal Function Call               62   Input past end of File
  505.  6   Overflow                           63   Bad record number
  506.  7   Out of memory                      64   Bad filename
  507. 11   Division by Zero                   67   Too many files
  508. 13   type mismatch                      68   Device unavailable
  509. 24   Device Timeout                     69   Comm-buffer overflow
  510. 25   Device fault                       70   Permission denied
  511. 52   Bad filename or number             71   Disk not ready
  512. 53   File Not Found                     72   Disk media error
  513. 55   File Already open                  74   Rename across disk
  514. 57   Device I/O error                   75   Path/File access error
  515. 58   File already exists                76   Path not found
  516. 59   Bad Record length
  517.  
  518.      The most common error that you will see is #62.  This is usually caused
  519. by the CFG file not having enough lines.  I have included this list so
  520. that you may be able to fix a problem that occurs with a T&J Software
  521. door.
  522.  
  523.      Error #75 is usually an incorrect path and/or filename in the CFG
  524. file.
  525.